Release 10.1A: OpenEdge Development:
Progress 4GL Reference

PAUSE statement

Suspends processing indefinitely, or for a specified number of seconds, or until the user presses any key.

Note: Does not apply to SpeedScript programming.

Syntax

PAUSE [ n ] [ BEFORE-HIDE ] [ MESSAGE message | NO-MESSAGE ] [ IN WINDOW window ]

n

A numeric expression specifying the number of seconds that you want to suspend processing. If you do not use this option, Progress suspends processing until the user presses any key.

BEFORE-HIDE

Specifies the pause action the user must take whenever frames are hidden automatically. If you specify n, n is the number of seconds Progress pauses before hiding. If you do not specify n, the pause lasts until the user presses a key.

MESSAGE message

Displays the message “Press spacebar to continue” on the status line of the terminal screen when Progress encounters a PAUSE statement. Use the MESSAGE option to override that default message. A message is a constant character string.

NO-MESSAGE

Tells Progress to pause but not to display a message on the status line of the terminal screen.

IN WINDOW window

Specifies the window to which the pause action applies. The value window must be a handle to a window. If you do not use the IN WINDOW phrase, the PAUSE statement applies to the current window.

Example

The FOR EACH block in this procedure reads each of the records from the customer table and displays information from each record. Because the DISPLAY uses a down frame (multiple records displayed in the frame), Progress usually fills the window with as many records as possible and then displays the message: “Press spacebar to continue”. The PAUSE 2 BEFORE-HIDE message tells Progress to pause only two seconds before hiding the frame and displaying additional records.

r-pause.p

PAUSE 2 BEFORE-HIDE MESSAGE "Pausing 2 seconds". FOR EACH customer WITH 13 DOWN: DISPLAY cust-num name. END.

Notes

After you use PAUSE, that statement is in effect for all the procedures run in that session unless it is overridden by other PAUSE statements in those procedures, or until you return to the Editor.
Using the PAUSE n BEFORE-HIDE statement is a good way to write a demonstration application that runs by itself.
Progress automatically pauses before removing a frame and displays the “Press spacebar to continue” message if you have not had a chance to see the data in the frame.
When a PAUSE occurs, Progress clears any keystrokes buffered from the keyboard, discarding any type-ahead characters.